Node / meshtastic / Meshtastic-Android / files / docs / fi-rFI / user / mqtt.md

Displaying Rendered • View raw • Download

title: MQTT

parent: Käyttöopas

nav_order: 11

last_updated: 2026-05-13

description: Siltaa mesh-verkko internetiin — MQTT-välityspalvelimen käyttöönotto, salauskerrokset ja karttadatan välitys.

aliases:

• mqtt

• internet-silta

• välityspalvelin

MQTT yhdistää Meshtastic-mesh-verkkosi internetiin ja mahdollistaa pitkän kantaman viestinnän radioalueen ulkopuolella.

MQTT-moduuli yhdistää radion MQTT-välityspalvelimeen, mahdollistaen:

• Viestien välittymisen eri fyysisten mesh-verkkojen välillä internetin kautta

• Integraation kotiautomaatio- ja valvontajärjestelmiin

• Radioiden sijaintien julkaisemisen julkiseen Meshtastic-karttaan

• Mukautetut dataputket tiedonkeruuta ja hälytyksiä varten

T282828

Internet-yhteydellinen gateway-radio (WiFi tai Ethernet) julkaisee mesh-viestit MQTT-aiheeseen. Etä-yhdyskäytävät, jotka ovat tilanneet saman aiheen, syöttävät viestit omaan paikalliseen mesh-verkkoonsa.

1. Siirry kohtaan Asetukset → Moduulin asetukset → MQTT.

2. Ota MQTT-moduuli käyttöön.

3. Määritä välityspalvelimen yhteys:

!MQTT kytkin

Yhteisö ylläpitää julkista välityspalvelinta osoitteessa T383838mqtt.meshtastic.org. Tämä on tarkoitettu yleiseen käyttöön ja testaukseen.

│ 🔒 Tietosuoja: Julkisen välityspalvelimen viestit ovat kaikkien tilaajien luettavissa. Käytä aina

│ kanavasalausta yksityiseen viestintään.

Parempaa yksityisyyttä ja hallintaa varten voit käyttää omaa MQTT-välityspalvelinta:

• Mosquitto (kevyt, avoimen lähdekoodin)

• HiveMQ

• EMQX

Määritä radiosi osoittamaan omaan välityspalvelimeesi oikeilla tunnistetiedoilla.

Kun karttajako (Map Reporting) on käytössä, radiosi julkaisee sijaintinsa Meshtastic-yhteisökartalle:

• Näkyvissä osoitteessa meshmap.net ja vastaavissa yhteisökarttapalveluissa

• Jaetaan vain sijainti- ja laitetiedot

• Poista käytöstä, jos et halua sijaintisi näkyvän julkisesti

Määritä kanavakohtaisesti, mitkä suunnat ovat käytössä viestiliikenteen ja lähetysajan käytön hallintaan.

MQTT käyttää protobuf-viestimuotoa:

│ ⚠️ Huom: JSON-ulostulotuki on poistettu firmwaresta. T383838json_enabled-asetus näkyy yhä sovelluksessa

│ taaksepäinyhteensopivuuden vuoksi, mutta sillä ei ole vaikutusta nykyisissä firmware-versioissa.

Kerrostetun salausmallin ymmärtäminen:

1. Kanavasalaus tapahtuu meshissä ennen MQTT:tä. Jos kanavallasi on PSK, MQTT-viestisisältö on jo salattu — välityspalvelin ja tilaajat näkevät vain salatun datan.

2. MQTT-salaus (moduuliasetus) lisää ylimääräisen salauskerroksen matkalla välityspalvelimelle. Tämä suojaa metatietoja ja reititystietoja.

3. TLS salaa TCP-yhteyden itse välityspalvelimeen estäen verkkotason salakuuntelun.

│ 🔒 Tärkeää: julkisella oletuskanavalla on tunnettu avain. Oletuskanavan MQTT:n kautta lähetetyt

│ viestit ovat käytännössä salaamattomia — kuka tahansa tilaaja voi purkaa ne. Käytä aina omaa

│ PSK-avainta yksityiseen viestintään.

• Käytä kanavatasoista salausta (PSK) kanavissa, jotka yhdistetään MQTT:hen

• Älä ota MQTT:tä käyttöön laitteissa, joilla ei ole internet-yhteyttä (se puskuroidaan ja kuluttaa muistia)

• Käytä yksityistä välityspalvelinta arkaluonteisissa käyttöönotossa

• Ole tarkkana lähetysajan (downlink) käyttämisessä ruuhkaisissa MQTT-aiheissa — jokainen viesti kuluttaa radio-aikaa paikallisessa meshissä

• Harkitse lähetyssuunnan vaihtamista (uplink), jos haluat vain seurata verkkoa etänä ilman viestien lähettämistä verkkoon

• Tarkista WiFi — yhdyskäytävän radiolla täytyy olla aktiivinen internet-yhteys (WiFi tai Ethernet). MQTT ei toimi LoRa-radiolinkin kautta.

• Tarkista tunnukset — väärä käyttäjänimi tai salasana epäonnistuu useimmilla välityspalvelimilla hiljaisesti Tarkista ylimääräiset välilyönnit

• Palomuuri — portti 1883 (MQTT) tai 8883 (MQTT+TLS) täytyy olla auki. Jotkin verkot estävät ei-standardit portit.

• DNS-ratkaisu – jos käytät omaa välityspalvelimen isäntänimeä, varmista että laite pystyy ratkaisemaan sen. Kokeile välityspalvelimen IP-osoitetta suoraan.

• Tarkista lähetys ja vastaanotto-asetukset – jos vain lähetys on käytössä, viestit kulkevat meshistä MQTT:hen mutta eivät takaisin. Ota vastaanotto käyttöön vastaanottavassa yhdyskäytävän laitteessa.

• Kanava ei täsmää – molempien gateway-laitteiden täytyy käyttää samaa kanavaa ja samaa PSK-avainta. Eroavaisuus tarkoittaa, että viestit on salattu eri avaimilla ja näyttävät roskalta.

• Aihe ei täsmää – varmista, että molemmat yhdyskäytävät käyttävät samaa juuriaihetta (Root Topic). Oletus T383838msh toimii julkisessa välityspalvelimessa.

• Asetukset — Moduulit ja ylläpito — MQTT-moduulin asetusten viite

• Viestit ja kanavat — kanavasalaus ja PSK-asetukset

• MQTT-integraatio-opas — yksityiskohtainen MQTT-dokumentaatio meshtastic.org -sivustolla